home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / educate / quiz305.zip / QUIZ.PAR < prev    next >
Text File  |  1996-04-26  |  19KB  |  459 lines

  1.  
  2. Command line options:
  3.  
  4.      The "command line" refers to what was typed at the  DOS
  5. prompt to start the Create A Quiz program.  For example,  if
  6. your Create A Quiz disk is located in drive A:, your  screen
  7. should display an  "A>" prompt.   When you type  the letters
  8. "QUIZ" before  you press  the [ENTER]  key, you  are at  the
  9. "command line".
  10.  
  11.      Additional text  can be  appended to  the command  line
  12. after the key word "QUIZ"  that will instruct Create A  Quiz
  13. to perform certain functions not available through the  menu
  14. selections.
  15.  
  16.      Please  note  that  the   following  options  are   NOT
  17. available in the "Lite" version  of Create A Quiz.   Command
  18. line  options  are  only   available  in  the  full-featured
  19. Teacher's and Student's versions.
  20.  
  21.  
  22.      QUIZ filename.QZ
  23.  
  24.      If  a  name  of  an  existing  .QZ file is added on the
  25. command line after the key  word "QUIZ", then that .QZ  file
  26. will  be  automatically  presented  to  the  user  once  the
  27. program  starts.   In  such  cases  the  "Main Menu" will be
  28. skipped, and the  student will be  greeted with a  prompt to
  29. enter his name, followed by the quiz.  In the above  example
  30. replace  the  word  "filename"  with  the actual name of the
  31. quiz you  wish to  use.   If your  quiz is  called "MATH.QZ"
  32. then  you  must  enter  "QUIZ MATH.QZ"  on the  command line
  33. before  running  the  program.
  34.  
  35.      Command line instructions can be combined or placed  in
  36. any  order.   In  other  words,  the  following command line
  37. instructions are all acceptable:
  38.  
  39.      QUIZ TIMEOUT=10 QTY=20
  40.  
  41.      The  command  line  instructions  above  will cause the
  42. program to end after 10 minutes of play have  elapsed or  20
  43. random questions have been attempted, whichever comes first.
  44.  
  45.      The remainder of the command line options are listed
  46. below in ALPHABETICAL order:
  47.  
  48. ------------------------------------------------------------
  49.  
  50.      QUIZ COMMA=x
  51.  
  52.      This  command  line  option  is  only  useful for those
  53. users living outside of  North America.  Here's  the problem
  54. for our  international users:  In the  USA a  decimal number
  55. uses a "." period character to separate the fractional  part
  56. from  the  whole  number  (e.g.,  "$4.50",  or  "a 2.0 liter
  57. bottle  of  Coke".   In  European  countries,  however,  the
  58. practice is to use a comma "," instead of a "." period.   So
  59. in our  example above,  you would  have "$4,50",  or "a  2,0
  60. liter  bottle  of  Coke".   A  problem therefore exists when
  61. teachers are creating "fill-in-the-blank" quizzes since  the
  62. comma character  is used  to separate  each possible correct
  63. answer.   How  then  does  the  program  know the difference
  64. between a comma  used in a  decimal number and  a comma used
  65. to separate multiple fill-in-the-blank answers?  The  answer
  66. is to use  the COMMA=x parameter,  and replace "x"  with the
  67. actual  character  you  wish  to  use as a separator between
  68. multiple "fill-in-the-blank" answers.  We recommend using  a
  69. semi-colon "COMMA=;"  however you  may wish  to use  another
  70. character if you desire.
  71.  
  72.  
  73.      QUIZ CONFIRM
  74.  
  75.      For those  student of  yours who  are heavy  handed, or
  76. all  thumbs,  you  can  give  them the opportunity to change
  77. their answer/response to a  quiz by adding the  command line
  78. parameter "CONFIRM".   After the student  selects/inputs his
  79. response,  a  confirmation  window  will  appear  asking the
  80. student if he is sure that he wants to accept his  response,
  81. with an option to return to the question and choose/input  a
  82. different  answer.   After  the  student  has  confirmed his
  83. response, his response will be judged "Correct" or "Wrong".
  84.  
  85.  
  86.      QUIZ DISPLAY filename.QZ
  87.  
  88.      The above command line instructions force Create A Quiz
  89. into a continuous loop  using "filename.QZ".  When  a player
  90. is prompted for his name,  the program will insist that  the
  91. user input his FULL name, AND address, city, state, zip  and
  92. phone  number  before  they  can  participate  in  the  quiz
  93. specified  by  "filename.QZ".   This  "DISPLAY" command line
  94. instruction  (with  .QZ  file)  turns  Create A Quiz into an
  95. excellent  sales  or  promotional  tool  for  businesses and
  96. organizations.  For example,  a company that specializes  in
  97. selling  and  installing  home  water  filters  can create a
  98. "WATER.QZ" file that  presents several questions  that tests
  99. a  prospective  client's  knowledge  of tap water, chlorine,
  100. heavy metals, cost comparisons, etc.   If Create A Quiz  has
  101. been  started  with  the  "WATER.QZ  DISPLAY"  command  line
  102. instructions,  then  WATER.QZ  will  be  presented  to  each
  103. client  that  approaches  the  company's  computer  display.
  104. Each user's  name and  address are  stored in  a file called
  105. "USER.LST".  The "USER.LST" file can later be retrieved  and
  106. used to print  out mailing labels  or possible client  list.
  107. Should you  wonder how  to stop  Create A  Quiz from looping
  108. into eternity  in the  "DISPLAY" mode,  enter "GOODBYE" when
  109. the input window prompts for a user's full name.  Of  course
  110. you  could  reboot  your  computer,  but  that's  not   very
  111. graceful...
  112.  
  113.  
  114.      QUIZ ENFORCE QTY=15
  115.  
  116.      The  command  line  parameter  "ENFORCE" when used with
  117. "STOPAT=" or "STARTAT=" or "QTY=" parameters will prevent  a
  118. student from  exiting the  program/quiz until  the specified
  119. range or quantity of questions have been attempted.
  120.  
  121.  
  122.      QUIZ FIBCHAR=x
  123.  
  124.      The way Create A Quiz determines whether a question  is
  125. a multiple-choice  or fill-in-the-blank  type is  by use  of
  126. the  underscore  "_"  character.   If  an  "_"  appears in a
  127. question (anywhere) then  that question is  assumed to be  a
  128. multiple-choice  type  question.   However,  there are times
  129. where  you  would  prefer  to  have  a  different  character
  130. determine  this,  therefore  use  the FIBCHAR=x command line
  131. parameter  where  "x"  is  replaced  with  the actual single
  132. character  that  will  determine   whether  a  question   is
  133. fill-in-the-blank or not.
  134.  
  135.  
  136.      QUIZ LOGFILE=xxxx
  137.  
  138.      The command line  parameter LOGFILE=xxxx will  save ALL
  139. questions  and  choices  presented  to  the student, AND the
  140. student's response.   Replace "xxxx" with  a legal DOS  file
  141. name.   Included  in  this  log  file  will be the student's
  142. name,  quiz  name,  date,  time,  and a summary of attempts,
  143. correct responses, etc.
  144.  
  145.  
  146.      QUIZ LOG1ST
  147.  
  148.      The  command   line  parameter   LOG1ST  is   used   in
  149. conjunction with  the QUIZ.WHO  file (see  advanced features
  150. section).   LOG1ST  will  cause  the  student  input  prompt
  151. window to appear only once EVER.  If the student attempts  a
  152. second quiz on another day, there will be no expanded  input
  153. prompts  to  greet  them  (asking  for address, city, phone,
  154. whatever...).   How  does  the  program  know  whether   the
  155. student is using  the program for  the first time?   Because
  156. when  LOG1ST  is  used,  it  will  automatically  delete the
  157. QUIZ.WHO file if it exists.   Since the QUIZ.WHO is used  to
  158. determine what input prompts  are displayed, if it  does not
  159. exist, then no expanded prompts will appear.  So in  review,
  160. LOG1ST with a  QUIZ.WHO file will  cause an expanded  player
  161. input field  window to  display the  first time  the student
  162. uses a  quiz.   The program  will then  automatically delete
  163. the  QUIZ.WHO  file,  which  means  any  future  uses of the
  164. program will  NOT display  an expanded  player input  prompt
  165. window.
  166.  
  167.  
  168.      QUIZ LPT=filename
  169.  
  170.      This  parameter  allows  you  to  redirect printouts of
  171. quizzes  (from the  editor) to  an ASCII  disk file by using
  172. the command line parameter LPT=filename.  Replace "filename"
  173. with a legal DOS file name.
  174.  
  175.  
  176.      QUIZ NAME=xxxx
  177.  
  178.      This parameter allows you to pass the name of a  single
  179. student/user to Create  A Quiz.   By passing this  value the
  180. "Please  enter  your  name:"  prompt  will not appear when a
  181. student selects a quiz.  Example:   QUIZ NAME=MIKE   If  the
  182. name you are using consists of more than one name, then  use
  183. an underscore character "_"  to connect each name  (example:
  184. QUIZ NAME=MIKE_R._JONES).
  185.  
  186.  
  187.      QUIZ NODOC
  188.  
  189.      This  parameter  is  only  valid  with  the   STUDENT'S
  190. EDITION of Create A Quiz.   This will prevent access to  the
  191. on-screen  documentation  file   (what  you  are   currently
  192. reading).
  193.  
  194.  
  195.      QUIZ NODUPES
  196.  
  197.      The   command   line   instruction   above when used in
  198. conjunction with  random question  mode will  ensure that no
  199. duplicating  questions  will  be  given  to the student.  In
  200. other words,  each question  presented to  the student  will
  201. appear only once (i.e., no duplicates).
  202.  
  203.  
  204.      QUIZ NOEDIT     * Not currently available
  205.  
  206.      The  NOEDIT  command  line  parameter  will  remove the
  207. "Create" and  "Edit" selections  from the  Main Menu  in the
  208. Teacher's Edition.   This is used  when you want  to prevent
  209. students from accessing or tampering with your quizzes.
  210.  
  211.  
  212.      QUIZ NOOPTS
  213.  
  214.      This command line parameter will suppress/withhold  the
  215. "Play Options  Menu".   This will  prevent the  student from
  216. changing  the  question  order,  printout,  or repeat errors
  217. options.   You  canNOT  currently  combine  the  NOOPTS  and
  218. RESTRICT  (see  above)  parameters,   since  some  form   of
  219. introductory menu will always be necessary.
  220.  
  221.  
  222.      QUIZ NOPCT
  223.  
  224.      The  teacher  can  customize  what  appears  on the top
  225. status  line  with  the  command  line parameters "NOPCT" or
  226. "NOSTATS".  The former will display the following:
  227.  
  228. ┌─────────────────────── WHO'S WHO ────────────────────────┐
  229. │ Name: James                 Attempts: 4     Left: 3      │
  230. └──────────────────────────────────────────────────────────┘
  231.  
  232. If you wish to suppress all of the status line use "NOSTATS"
  233. and you will instead have the following header:
  234.  
  235. ┌──────────────────────────────────────────────────────────┐
  236. │              WHO'S WHO - LESSON 1 - FAMOUS MEN           │
  237. └──────────────────────────────────────────────────────────┘
  238.  
  239.  
  240.      QUIZ NOQS
  241.  
  242.      Adding the command line parameter "NOQS" will turn  off
  243. the  familiar  ?  ¿  wallpaper  symbols  that  appear on the
  244. screen.
  245.  
  246.  
  247.      QUIZ NOREVIEW
  248.  
  249.      When a student takes a quiz in which a  multiple-choice
  250. question  is  presented,  the  student  has to select from a
  251. list of possible correct answers.  If the student picks  the
  252. wrong answer, the message "xyz IS INCORRECT!" At this  point
  253. the student may still not know the correct answer.  Also  at
  254. this  point  an  instruction  prompt  at  the  bottom of the
  255. screen offers the  student to reveal  the answer (or  review
  256. the choices) by  pressing the [R]  key.  Should  the teacher
  257. wish to withhold this  prompt, and prevent the  student from
  258. discovering the correct answer  he missed, add the  NOREVIEW
  259. parameter on the command line when starting Create A Quiz.
  260.  
  261.  
  262.      QUIZ NOSCORE
  263.  
  264.      If you  DON'T want  your students'  progress or  scores
  265. recorded via  the scoreboard,  add "NOSCORE"  to the command
  266. line.
  267.  
  268.  
  269.      QUIZ PLAYERS=1
  270.  
  271.      If you would like to  skip over the "How many  students
  272. are participating?:"  prompt when  your users  begin using a
  273. quiz (particularly when ONLY  ONE USER would ever  be taking
  274. your quiz), then specify  the number of participants  on the
  275. command line  with "PLAYERS=x"  where "x"  is replaced  with
  276. actual number of participants.
  277.  
  278.  
  279.      QUIZ QTY=x
  280.  
  281.      The above  "QTY=" command  line option  can be  used to
  282. force Create  A Quiz  to stop  and return  to DOS  after "x"
  283. number  of  random  questions  have  been  attempted  by the
  284. student.  You can replace  the "x" with any positive  number
  285. that you wish.  For example, "QUIZ QTY=20".
  286.  
  287.  
  288.      QUIZ REFNOTES
  289.  
  290.      The parameter REFNOTES  will AUTOMATICALLY display  any
  291. EXTENDED LENGTH reference notes  that are associated with  a
  292. question during  play after  the student  has entered  their
  293. answer.  Any  reference notes will  be displayed in  a full-
  294. screen window for easier reading.   If REFNOTES is not  used
  295. (default),  then  the  student  taking  a  quiz will have to
  296. press the [D]  key to manually  display any extended  length
  297. reference notes.
  298.  
  299.  
  300.      QUIZ RESTRICT filename.QZ
  301.  
  302.      The  additional  word  "RESTRICT"  on  the command line
  303. will  prevent  the  student/user  from  reaching  the  "Main
  304. Menu".  This  is useful if  you have given  the program disk
  305. to  a  student and have  created a batch  file to force  the
  306. student to use  a particular quiz,  but you do  not want the
  307. student to gain  access to the  "Main Menu" where  he may be
  308. able  to  change  your  questions  or  answers,  or peek and
  309. cheat.
  310.  
  311.  
  312.      QUIZ SCOREALL
  313.  
  314.      The student taking a quiz will be allowed to  determine
  315. whether they  want their  scores recorded  to the scoreboard
  316. when they are finished.  If the teacher wishes to  eliminate
  317. this option, forcing the  student's score to be  compared to
  318. the  top  10  scoreboard  instead,  then  add  the  SCOREALL
  319. parameter.  Although  SCOREALL will not guarantee that  your
  320. student's  score  will  be  added  to  the  top  10, it will
  321. guarantee that  the student's  score will  be compared  with
  322. the current scoreboard.  If you want to guarantee that  your
  323. student's score is recorded  to the scoreboard, then  delete
  324. the  *.SCB  scoreboard  file  before  taking  the  quiz.  By
  325. deleting  the  appropriate   *.SCB  scoreboard  file,   your
  326. student's  score   will  definitely   be  recorded   in  the
  327. scoreboard since there  will be no  other scores to  compete
  328. against.
  329.  
  330.  
  331.      QUIZ SCORELOG=ON
  332.  
  333.      Since  the  scoreboard  only  records  the  top 10 high
  334. scores, there may be times when your student/user obtains  a
  335. score worth knowing about and  yet falls short of making  it
  336. into the "top  ten" scoreboard.  To maintain a record log of
  337. your  user's  scores  (regardless  of  the  score),  use the
  338. "SCORELOG=ON" parameter.  This  will cause Create A  Quiz to
  339. maintain a file with all user's scores, along with date  and
  340. quiz used.  The file  generated will be straight ASCII  text
  341. and will automatically be named "SCORE.LOG".
  342.  
  343.  
  344.      QUIZ SCRAMBLE
  345.  
  346.      When taking  a multiple  choice quiz,  you will  notice
  347. that  the  "pick  list"  of  possible answer choices appears
  348. exactly in  the same  order as  the answers  were entered by
  349. the teacher  when first  creating that  question.   In other
  350. words, if a multiple choice question exists where...
  351.  
  352.        Question: How much is 1 + 1?
  353.  
  354.        Answer: 2
  355.        Answer: 4
  356.        Answer: 6
  357.        Answer: 8
  358.        Answer: 11
  359.  
  360. ...when  your  student  is presented this  question within a
  361. quiz on the screen,  the order of answers  "2,4,6,8,11" will
  362. be  identical  to  the  order  in  which the teacher entered
  363. them.   If,  however,  you  would  like  to see the order of
  364. answers SCRAMBLED up, then  add the "SCRAMBLE" command  line
  365. parameter when starting QUIZ.  The scramble that will  occur
  366. will vary from moment to  moment, so that if a  question was
  367. to reappear twice, the  order of answers would  be different
  368. from the first appearance.
  369.  
  370.  
  371.      QUIZ STARTAT=10 STOPAT=20
  372.  
  373.      The  above  combination  of  "STARTAT="  and  "STOPAT="
  374. commands  instruct  Create  A  Quiz  to  start at a specific
  375. question  number   and  to   display  subsequent   questions
  376. sequentially  (10,  11,  12,...19,  20).   Once  the  number
  377. designated by  "STOPAT=" is  reached, the  program will exit
  378. to  DOS.   If  you   use  "STARTAT="  without  a   "STOPAT="
  379. statement, Create A Quiz  will still proceed with  questions
  380. sequentially  until  the  very  last  question is reach, and
  381. then will terminate.
  382.  
  383.  
  384.      QUIZ SURVEY
  385.  
  386.      Create  A  Quiz  can  be  transformed  into  "Create  A
  387. Survey", with  the command  line parameter  "SURVEY".   What
  388. this  parameter  does  is  turn  off  all  scoring (no score
  389. header, no scoreboard), and  records all responses from  the
  390. student during a  quiz in an  ASCII file "RECORD.LOG".   The
  391. student's name, the quiz, the date and time, in addition  to
  392. all the  responses to  the questions  are maintained  in the
  393. RECORD.LOG file on the default disk.  There are no right  or
  394. wrong answer messages displayed when "SURVEY" is used.
  395.  
  396.  
  397.      QUIZ TIMEOUT=x
  398.  
  399.      The above  "TIMEOUT=" command  line option  can be used
  400. to force Create A Quiz to  stop and return to DOS after  "x"
  401. number of minutes have elapsed since the first question  was
  402. attempted by the student.  You can replace the "x" with  any
  403. positive  number  that  you   wish.   For  instance,   "QUIZ
  404. TIMEOUT=5" will cause the program to end after 5 minutes  of
  405. play have elapsed.
  406.  
  407.  
  408.      QUIZ 4AGRADE
  409.  
  410.      If you as a teacher would like to grade your  students'
  411. knowledge of a quiz  but do not want  them to know how  they
  412. scored,  then  use  the  command  line  parameter "4AGRADE".
  413. This command will instruct Create A Quiz to 1) suppress  the
  414. "Correct" or "Wrong" result  window; 2) suppress the  status
  415. header  from  displaying  "Correct:"  and  "Percent:".   The
  416. teacher will find the student's answers/responses in a  file
  417. called  "RECORD.LOG"  and  their  scores  in the "SCORE.LOG"
  418. file.
  419.  
  420. ------------------------------------------------------------
  421.  
  422.      With  all  the  above   command  line  parameters   now
  423. available, it can  get very crowded  at the DOS  prompt when
  424. you try to  create a custom  environment for your  students.
  425. To eliminate the lengthy DOS command line startup, the  user
  426. can  now  create  a  QUIZ.CFG  file and enter the parameters
  427. into that file  rather than type  the parameters at  the DOS
  428. prompt.  Here's an example...  Instead of typing...
  429.  
  430. QUIZ TESTME.QZ NODUPES STARTAT=1 SCRAMBLE
  431.  
  432. ...at the  DOS prompt  you can  create an ASCII file, and on
  433. line #1 of the QUIZ.CFG file place just the following text:
  434.  
  435. TESTME.QZ NODUPES STARTAT=1 SCRAMBLE
  436.  
  437.      Next time when you  start the program (just  type QUIZ)
  438. the  QUIZ.CFG  will  be  looked  for,  and if it exists, the
  439. first line will be loaded and the parameters used.
  440.  
  441.      If you wish to  ENCRYPT your QUIZ.CFG file,  to prevent
  442. users from modifying your setup, you can accomplish this  by
  443. starting the  Teacher's version  with the  following command
  444. line:  QUIZ ENCRYPT QUIZ.CFG
  445.  
  446.      The above  command will  automatically invoke  Create A
  447. Quiz and instruct it to take the existing QUIZ.CFG file  and
  448. rewrite it to disk  as a READ-ONLY, ENCRYPTED  QUIZ.CFG file
  449. (with CRC  verification), and  then exit  the program.   The
  450. next time you type "QUIZ", the encrypted QUIZ.CFG file  will
  451. then be used.
  452.  
  453.      If you  attempt to  delete an  encrypted QUIZ.CFG file,
  454. you will be  unsuccessful, since it is READ-ONLY.   You must
  455. reset  the  file  attribute  with  DOS'  ATTRIB  -R QUIZ.CFG
  456. command.  Once reset, you  can then delete the QUIZ.CFG  and
  457. create a new one.
  458.  
  459.